home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / doorhelp.zip / DOORWAY.TXT next >
Text File  |  1992-09-18  |  10KB  |  184 lines
  1. Running Standard DOS Applications as Doors
  2. Using PCBoard 14.5a and Doorway
  3. -------------------------------
  4.  
  5. Supported Applications:
  6. -----------------------
  7. Standard DOS applications that produce monochrome or color text displays and
  8. are operated via keyboard.  Bit mapped graphics (such as Windows) and mouse
  9. operation are not supported.
  10.  
  11. Special Considerations:
  12. -----------------------
  13. If the application being used as a PCBoard door requires the use of function
  14. keys, or other special keys such as 'Page Up' or the arrow keys to operate,
  15. or if it displays information on the bottom (25th) line of the screen, the
  16. communications program that the caller uses to call your bulletin board must
  17. support a 'Doorway' mode of operation.
  18. Normally, a communications program uses the bottom line of the screen as a
  19. 'status line', and intercepts many of the keys on the keyboard for its own
  20. functions.  Doorway mode causes the communications program to not use the
  21. bottom line of the screen, and pass all keystrokes through to the door
  22. application running on the BBS machine.
  23. Many popular communications packages support Doorway mode; a partial listing
  24. is provided here for reference.  This list is not complete, nor does the
  25. appearance of a program name here imply any endorsement upon the part of the
  26. author or Clark Development Co., Inc.
  27.  
  28. Communications Programs with Doorway Mode:
  29. ------------------------------------------
  30. Procomm         V2.00 and higher (limited)
  31. 1st Reader      All versions
  32. Robocomm        All versions
  33. Pibterm         V4.1 and higher
  34. K9X             V8.00.3 and higher
  35. ZComm           V17 and higher
  36. Telix           V3.12 and higher
  37. Boyan           V4.1 and higher
  38. GT Power        V15.5 and higher
  39. Commo           All versions
  40. JaxCom          All versions
  41. DWComm          All versions
  42. Com-And         V2.38 and higher
  43. Qmodem          V3.1a and higher
  44.  
  45. Memory Considerations:
  46. ----------------------
  47. When PCBoard runs your application program through Doorway, PCBoard is
  48. unloaded from memory first - then Doorway loads your program and remains
  49. resident.  This means that your application will have less than the full
  50. 640K of memory to work in.  You can determine how much memory your
  51. application will have available on your system by doing this:
  52. Run CHKDSK, and make a note of the memory available before loading PCBoard.
  53. Then subtract 80K from this figure - the balance is what your application
  54. will have available when running in a door.
  55.  
  56. Display Considerations:
  57. -----------------------
  58. Special considerations can arise when running DOS application programs
  59. remotely in regard to the display colors.  The DOS application you are
  60. running will in most cases automatically sense the display type of the
  61. machine it's running on (the BBS) and display color or black and white
  62. as appropriate.
  63. Doorway and the remote communications program will display what is shown on
  64. the BBS machine's screen as is, so if the BBS machine is equipped with a
  65. monochrome display system and the person calling in has color, he'll see the
  66. application in black and white.  Some DOS application programs have an
  67. option to select the display type; set it for color output if possible in
  68. this situation.
  69.  
  70. Network / Multi-tasking operations:
  71. -----------------------------------
  72. Both PCBoard and Doorway are fully capable of sharing files in a multi-user
  73. environment.  If you are running a multi-node system and wish your DOS
  74. application to be used by more than one caller at a time, you'll need to
  75. make sure that the DOS application is 'network compatible' and capable of
  76. sharing its data files with other copies of the application running at the
  77. same time.  Use of single-user application programs as multi-user doors will
  78. almost certainly result in a system crash when two or more people try to use
  79. that door at the same time.
  80.  
  81. Installing Doorway for use with PCBoard:
  82. ----------------------------------------
  83. The only required file from the Doorway distribution disk or shareware ZIP
  84. file is DOORWAY.EXE.  This file should be copied into the same directory as
  85. your PCBoard system files; usually, this is C:\PCB.
  86.  
  87. Setting Up Your Application as a Door:
  88. --------------------------------------
  89. Let's examine the setup and configuration of a typical DOS application being
  90. used as a door on a PCBoard system.  For this example, we're setting up a
  91. hypothetical database application called FOOBASE.  Foobase has already been
  92. installed in accordance with its installation instructions, and is located
  93. in the C:\FBASE subdirectory.
  94. PCBoard has also already been installed in accordance with the installation
  95. instructions, and is located in the C:\PCB subdirectory.  Also, there is a
  96. copy of DOORWAY.EXE located in this C:\PCB subdirectory.
  97.  
  98. First Step - Create the Door Batch File:
  99. ----------------------------------------
  100. Each PCBoard door is controlled by a batch file that is executed by PCBoard
  101. when the door is opened.  The name of the door batch file is somewhat
  102. special; the name of the door is the same as the name of the batch file, and
  103. the batch file is saved WITHOUT the .BAT extension.  We'll call our sample
  104. door FOOBASE, so that's the name of the batch file as well.  Here's the
  105. batch file that will run our sample door:
  106.  
  107.         ECHO OFF
  108.         DOORWAY COM1 /CD /H: /K:300 /V:D /P:C:\FBASE\FOOBASE.EXE
  109.         CD \PCB
  110.         BOARD
  111.  
  112. Note the last two lines; this returns to the PCBoard home directory and
  113. restarts the board after the door program is finished.  This is very
  114. important; make sure your door batch file ends this way.
  115. But the interesting part here is that big complicated command line that runs
  116. our FooBase application under Doorway.  Let's examine that line in detail to
  117. see what all those parameters mean.
  118.  
  119. DOORWAY                         The name of the Doorway program
  120. COM1                            The com port that our system is using
  121. /CD                             Change to /FBASE directory to run our program
  122. /H:                             Prevent any shells to DOS from this application
  123. /K:300                          Disconnect caller if no keys pressed for 5 min.
  124. /V:D                            Detect direct screen writes
  125. /P:C:\FBASE\FOOBASE.EXE         The program that we're running
  126.  
  127. In many cases, you can set your DOS application up using this sample file.
  128. Just substitute the proper COM port, path and program names and name the
  129. batch file as you desire.  Remember, no .BAT extension, please!  Your door
  130. batch file should be stored in the same location as your DOS application;
  131. in the example above, the FOOBASE door batch file would be located in the
  132. C:\FBASE subdirectory.
  133.  
  134. Second Step; Install the door in PCBoard
  135. ----------------------------------------
  136. Now let's install our hypothetical FOOBASE door into PCBoard.  This is done
  137. by editing the DOORS.LST file using PCBSetup.  Run PCBSetup, and either
  138. select the 'Main Board Configuration' screen or the 'Conferences' screen
  139. depending on whether you are installing the door into the main board or one
  140. of the conferences.
  141. On the conference / main board configuration screen, move the highlight bar
  142. to the 'Doors' 'Path/Name List File' field.  Press the F2 key, and you will
  143. be in the 'Edit DOORS File' screen.
  144. Insert a line into this file by pressing <Alt-I> and fill it in with the
  145. information for our door.  The first entry is the door name; this is the
  146. same as the name of the door batch file, remember?  So, put FOOBASE there.
  147. The next field is for an optional password that is needed to open this door;
  148. if you don't want to require a password to use this door, leave this field
  149. blank.  Next is the 'Security' field; place the minimum security level
  150. required to open the door here.  If you'd like everyone to be able to use
  151. the door, put a 0 (zero) here - otherwise, put the minumum security level
  152. needed to open the door here.
  153. Next is the 'Login' entry; if you put a Y here, the door will automatically
  154. open whenever someone logs in.  For most purposes, you'll want to leave this
  155. set to N.  The next two entries - 'USER.SYS and DOOR.SYS' are not applicable
  156. to DOS applications running under Doorway; leave these settings as N also.
  157. The 'Shell' field should also contain a N; this will provide the most free
  158. memory for your application.  Last of all is the 'Path to Door Files' field;
  159. this field should contain the complete path to where the door batch file is
  160. located.  For our sample, this would be C:\FBASE\.
  161. Now that all the fields for our new door are filled in properly, press the
  162. Esc key and answer Y to the 'save file' prompt.  Exit PCBSetup and our door
  163. is now installed.  The final touch would be to edit the DOORS menu file to
  164. include the name of the new door.
  165.  
  166. All done!
  167. ---------
  168. The mythical FOOBASE door is now ready for use.  When a caller logs into the
  169. bulletin board, they can just type FOOBASE at the command prompt and they'll
  170. be able to run the program from their remote location just as if they were
  171. sitting at the BBS machine.  Of course, they should put their communications
  172. program into Doorway mode before running our door, so that they'll be able to
  173. use all the keys on their keyboard.
  174.  
  175. Lots more options:
  176. ------------------
  177. Doorway and PCBoard provide many more options for setting up doors than are
  178. discussed in this document.  The simple sample setup described here is
  179. typical of most installations - but you may have a specific situation that
  180. requires a different setup.  To find out more about the possibilities,
  181. please refer to the Doorway documentation for details on all of its features
  182. and functions - and the PCBoard documentation for additional information on
  183. doors and their setup.
  184.